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Preface 



This manual explains how to use the communications 
feature with the IBM 5100 Portable Computer. 

To understand this manual, you should know how to 
operate the 5100 using APL or the BASIC language. You 
should also be familiar with communications concepts and 
terminal operations. 
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How to Use This Manual 



This manual is organized into the following topics: 

• Introduction describes the communications feature. 

• Operation of the Communications Feature describes how to load and initialize the 
program, the format of the display screen and extended display, how data is trans- 
mitted and received, the format of the communications status line, and the scroll and 
edit operations. 

• Operation of the Keys describes the function keys used during communications. 

• Communications Commands describes the commands used during communications. 

• l\/lessage Input and Output Devices describes the function of the input and output 
devices during communications. 

• State Indicators describes the states of the program and what you can do during each 
state. 

• Error Codes describes the error codes that are displayed on the status line. 

• Appendixes A, B, and C contain installation instructions, sample programs, and 
translation code charts. 

After reading the Introduction and the Operation of the Communications Feature, you 
should be able to sign on with a remote system, use the IBM 5100 Portable Computer to 
transmit data from the keyboard, and receive data. The remaining sections of the manual 
provide you with a detailed explanation of 5100 operations during communications. 



introduction 



With the Communications Adapter feature, the IBIVI 5100 Portable Computer 
transmits data to and receives data from a remote system. The 5100 appears 
the same as an IBIVI 2741 Communications Terminal to the remote system, and can 
communicate with many systems that support the 2741 (start-stop mode) with 
EBCD (extended binary coded decimal) notation. 

The 5100 communications feature allows you two options, T (tape option) or 
P (print option). When you select option T, data can be entered from the 
keyboard or tape unit and limited-length messages from the remote system can be 
printed and/or written on tape. When you select option P, all messages received 
from a remote system can be printed as they are received, but the tape unit cannot 
be used for input or output. With either option T or P, data transmitted and 
received is displayed on the display screen. 
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Operation of the Communications Feature 



LOADING AND INITIALIZING THE COMMUNICATIONS PROGRAM 

If the communications feature is installed on your 5100, you can now prepare the 
5100 for communications. (For customer installation and checkout, see Appendix A. 
Installation Instructions. ) First, start the 5100 for normal language operation and 
insert the tape cartridge containing the communications program in the built-in tape 
unit. Enter the command )MODE COM if you are using APL or UTIL MODE COM 
if you are using BASIC, and press EXECUTE. The 5100 then displays the options 
available: Enter T if you want to use the tape units, or enter P if you want to print 
long messages. If the printer is not installed, the options are not displayed and 
option T is selected automatically. 

The communications program is now ready to be initialized using the &SYSTEM 
and &RATE commands. &SYSTEM specifies the type of remote system you intend 
to communicate with so the 5100 will use the correct EBCD translation; it also 
specifies the error recovery. &RATE (for option T only) specifies the communication 
line rate in bits per second (bps). The & is entered by holding down the CMD key 
and then pressing the alphameric 1 key. The SYSTEM and RATE commands are 
entered from the keyboard following the &. The commands you use depend on how 
you are using the communications feature and on the system with which you are 
communicating. For the correct parameters to be entered with the commands for 
your system, see Communications Commands for &SYSTEM and &RATE. 

After entering the commands, establish a line connection with the remote system. 
If you are using non-switched lines, the 5100 is online; however, if you are using 
switched lines, you must dial the remote system to put the 5100 online. Enter the 
appropriate sign-on for your remote system. The 5100 is now ready to communicate. 



DISPLAY SCREEN AND EXTENDED DISPLAY 

The display screen contains 16 lines, each 64 characters long. The bottom line on 
the screen is the status line, which contains information on the status of the 
communications operation. (For a description of the messages that appear on the 
status line, see Communications Status Line.) The next line on the screen (the line 
above the status line) is the line on which data is displayed as it is transmitted and 
received; this is called the input line. The remaining 14 lines, plus the extended 
display, store the transmitted and received data. 

The extended display is an area in 5100 storage where transmitted and received data 
is stored. The approximate size of the extended display for each 5100 model is: 

5100 Model Size 

A1, 81, CI IK (K= 1024 characters) 

A2, B2, C2 17K 

A3, B3, C3 33K 

A4, 84, C4 49K 
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When data is entered in the extended display and the extended display becomes full, 
the oldest line is deleted when a new line is entered. 

Data in the extended display can be thought of as a page of data lines. A line 
contains the data between new-line and/or line feed function characters. A message 
contains the data between the start of transmission and end of transmission function 
characters and contains one or more lines. These function characters are transmitted 
by the 5100 and the remote system to control the length and spacing of the lines. 

Normally, the first 64 characters of the 14 most recent lines of the extended display 
are displayed on the screen; however, by using the scroll keys, you can move any 
part of the extended display to the screen. 



TRANSMITTING FROM THE KEYBOARD 

When the 5100 is online with a remote system, each character you enter from the 
keyboard is displayed on the screen and transmitted to the remote system. When 
you enter a line longer than 64 characters, each additional character entered is 
displayed in position 64 and all data on the display screen moves one position to 
the left. Pressing EXECUTE indicates the end of the line and moves the data on the 
display screen up one line and to the right so the first character of each line is in 
position 1 on the display screen. 



RECEIVING 

If the 5100 is receiving data, each character is displayed on the screen as it is 
received. A line containing 64 characters or less is displayed exactly as it is 
received. Lines longer than 64 characters are formatted into 64-character lines on 
the display screen as they are received. When the end of transmission character is 
received, the format of the longer lines changes and only the first 64 characters of 
each line are displayed. The part of the lines not displayed is stored in the extended 
display and can be moved to the screen by using the scroll keys. 



COMMUNICATIONS STATUS LINE 

The bottom line of the display screen is the status line. Functions such as copy 
display and HOLD may alter the format of the status line. The status line returns 
to its normal format when the 5100 goes to the home state. The positions of the 
status line indicate: 

Position Meaning 

1-5 The number of the character position in the extended display 

that appears in position 1 on the display screen. 

17-27 General status area. 

28-40 Tape status area. 

41-51 Printer status area. 

53-56 State indicator. 

58 and 60 Communication line status: 

D -V No line connection exists. 

D + The line connection has been made. 

D -^ The 5100 is receiving. 

D -> The 5100 is transmitting. 

64 Line indicator: 

-^ At least one of the lines on the display screen is 

longer than 64 characters, and the last part of 
the line is not displayed. 

f The last character of the longest line displayed on 

the screen is in position 64. 

No arrow At least one unused character position remains to 
(blank) the right of the longest line on the display screen. 



SCROLL 



During the scroll operation, you can display any part of the extended display on the 
screen. Normally, the first 64 characters of the last 14 lines entered in the extended 
display are displayed on the screen; this is the home position of the extended display. 
Positions 1 to 5 and 64 of the status line are useful in scroll operations because they 
indicate whether any data is to the left or right of the display screen (see 
Communications Status Line). 
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To move data on the display screen, use the scroll keys, which are activated by 
holding down the CMD key and pressing a specific numeric key. The scroll keys 
only move the data if there is data in the extended display to be moved to the 
screen. The scroll keys are: 



Key 



EJ 

Q 
Q 
Q 

Q 



Function 

Fast left scroll Moves the data on the display screen 20 

positions to the left. 

Fast right scroll Moves the data on the display screen 20 

positions to the right. 

Fast up scroll Moves the data on the display screen up 14 

lines. 

Fast down scroll Moves the data on the display screen down 

14 lines. 

Scroll left Moves the data on the display screen one 

position to the left. 

Scroll right Moves the data on the display screen one 

position to the right. 



The following keys perform the same function in communications as they do in APL 
or BASIC language operations: 



Scroll up 



Moves the data on the display screen up one 
line. 



Scroll down 



Moves the data on the display screen down 
one line. 



Pressing the home key (CMD and alphameric 8) ends the scroll operation and moves 
the data on the display screen to the home position. The edit key also ends the 
scroll operation and starts the edit operation. 



EDIT 



During the edit operation, you can edit the data in the extended display, print it, 
write it on tape, or compose a nnessage offline (see Composing Messages Offline). 
The keys used during the edit operation are activated by holding down the CMD 
key and pressing a specific alphameric key: 

Key Function 

a Edit Starts the edit operation. 

DLine delete Deletes all characters on the input line to the 

right of and at the cursor position. 



CD 



D Print Prints the data stored in the extended display 

from the input line to the end of the extended 
display. 






Home Restores the data on the display screen to the 

home position in the extended display. 

Write Writes the data stored in the extended display 

(option T only) on tape from the input line to the end of the 

extended display. 



You must position the line to be edited on the input line by using the scroll keys 
before starting the edit operation. When you press the edit key, the first 64 character 
positions of each line are displayed, and the cursor is in position 1. 

During the edit operation, the delete and insert functions and the backspace and 
forward space keys operate as they normally do during APL or BASIC language 
operations. If you press the backspace key when the cursor is at the left edge of the 
display screen (position 1) and positions 1 to 5 on the status line do not indicate 
00001 , all the data moves to the right. If you press the forward space key when the 
cursor is at the right edge of the display screen (position 64) and an arrow is 
displayed in position 64 of the status line, all the data moves to the left. Positions 
1 to 5 and 64 of the status line indicate whether any data is to the left or right of 
the display screen (see Communications Status Line). 

After the line is edited, you can transmit it by pressing the EXECUTE or ATTN key. 
Aii data in tfie extended display following the edited line is deleted. New data is 
added to the extended display following the edited line. 

To terminate the edit operation, press the EXECUTE, ATTN, or home (CMD and 
alphameric 8) key. If you press the home key after editing is complete, the displayed 
data returns to the home position, the edited line is not transmitted, and all the data 
following the edited line in the extended display is deleted as explained previously. 
If you press the home key before any editing is done, the displayed data returns to 
the home position and no data is lost from the extended display; therefore, you can 
end the edit operation without losing any data. 
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Operation of the Keys 



The following keys perform the same functions in communications as they do in 
APL or BASIC language operations: 

Scroll up 



Scroll down 

Backspace (delete function) 

Forward space (insert function) 



ATTN KEY 



The action of the ATTN key depends on which communications operation is beit 
performed and whether the ATTN key is pressed with another key: 



Transmit 



When the 5100 is transmitting data from the keyboard, pressing ATTN sends an end 
of transmission character and ends the transmission. The data transmitted is not 
printed or written on tape. The 5100 then waits to receive data from the remote 
system, and any data received is added to the end of the data just transmitted. When 
the end of transmission character is received from the remote system, the data 
transmitted and the data received will be printed and/or written on tape as one 
message. 



Receive 



When the 5100 is receiving data, pressing ATTN sends a long space (receive 
interrupt), and the 5100 continues receiving until the remote system sends an end 
of transmission character. OUT (0 backspace U backspace T) characters are placed 
in the received message to indicate a possible loss of data. When the remote system 
ends its transmission, the 5100 changes its state to home. 



Edit 



Pressing the ATTN key during an edit operation transmits the edited line and an end 
of transmission character. This is the same as pressing ATTN during transmit 
operations. If you press ATTN after a command is entered, the command is 
processed. 



Shift Key 



Holding down the shift key and then pressing ATTN stops the TAPEIN or AUTO 
operation before the next transnnission and opens the keyboard for input. 



CMD Key 



Holding down the CMD key and then pressing ATTN returns the 5100 to the honne 
state. This key is only to be used if the 5100 cannot be returned to the home state 
from the process (PROC) state by pressing only the ATTN key. 



RESEND 



When you are using the APLSV translation with the &SYSTEM command and the 
remote system transmits RESEND, you can interrupt the retry operations by 
pressing ATTN while the 5100 is receiving the characters RESEND. 



EXECUTE KEY 

During a transmit operation, pressing the EXECUTE key transmits the new-line and 
end of transmission characters. During an edit operation, pressing the EXECUTE 
key transmits the edited line and the new-line and end of transmission characters. 
If you press the EXECUTE key after a command is entered, the command is 
processed. 



HOLD KEY 

Pressing the HOLD key at any time during communications stops the operation as 
soon as possible and displays the characters HOLD in position 2 to 5 of the status 
line. You can continue the operation that was stopped by pressing the HOLD key 
again. When pressed with the CMD key, the HOLD key stops all operations 
immediately and may require reloading of the communications program. 



SPECIAL FUNCTION KEYS 

The top row of alphameric keys and several numeric keys have a special function in 
communications. Hold down the CMD key and press the appropriate key to 
activate the special function, which is as follows: 



Command Character 







The command character is displayed as & and identifies a communications command. 
It can be entered only when the 5100 is in the home state; in any other state the 
command character is ignored. 
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Edit 



CD 



The edit key starts the edit operation if the 5100 is in the honr>e or scroll state. 
To change the data on the input line of the display screen, use the backspace and 
forward space keys and the insert and delete functions. To end the edit operation, 
press the ATTN or EXECUTE key to transmit the edited line, or press the home 
key. 



Line Delete i < 



During an edit operation, pressing the line delete key deletes all characters on the 
input line to the right of the cursor, including the character at the cursor position. 



Shift Lock 



m 



Pressing the shift lock key once locks the keyboard in upper shift. The keyboard 
remains locked in upper shift until you press the shift lock key again, the EXECUTE 
or ATTN key while the 5100 is online, or press the shift key and enter an upper shift 
character. 

If the last character transmitted was a lower shift character, pressing the shift lock 
key transmits an upper shift function character and locks the keyboard in upper 
shift. If the last character transmitted was an upper shift character, pressing the 
shift lock key only locks the keyboard in upper shift; no upper shift function 
character is transmitted. When the keyboard is locked in upper shift, pressing the 
shift lock key transmits a lower shift function character and unlocks the keyboard. 
When the keyboard is locked in upper shift, pressing the shift key with the last 
character transmitted only unlocks the keyboard; no lower shift function character 
is transmitted. 



Tab Set 



m 



Pressing the tab set key sets a tab at the cursor location; no tab character is 
transmitted. Tabs cannot be set beyond position 132. 



Tab Reset 



Pressing the tab reset key clears the tab, if any, at the cursor position. No data is 
transmitted when this key is pressed. 
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Print 



m 



To print the data in the extended display during an edit operation, press the print 
key. Printing starts with the data moved to the input line on the display screen and 
continues through the last full line of the extended display. (The last full line is the 
line above the input line when the data is in the home position.) 



Home 



Pressing the home key during a scroll or edit operation moves the displayed data to its 
home position, which displays the first 64 characters of the 14 most recent lines of 
the extended display. Pressing the home key also ends the edit operation without 
transmitting the edited line, and if the line was not edited, no data is lost from the 
extended display. You can also use the home key to remove the bypass function 
(print inhibit), if it is active. The bypass function is activated by the remote system 
to inhibit output from the 5100 for security purposes. To ensure data security, you 
should not use the edit operation or the &TAPEIN command when the bypass 
function is active. 



Write f V 1 (Option T Only) 



m 



To write the data in the extended display on tape during the edit operation, press 
the write key. Writing starts with the data moved to the input line of the display 
screen and continues through the last full line of the extended display. (The last full 
line is the line above the input line when the data is in the home position.) In order 
to write data on tape, the tape must have been previously marked and the tape file 
opened for output. To protect the data written on tape, enter the &CLOSE command 
after the write operation is complete. 



OUT Character 



CD 



Pressing this key displays the OUT character (O backspace U backspace T) on the 
input line on the display screen and also transmits it if the 5100 is transmitting. 
Use this key to escape from the quad quote ( Q ) request for input when the 5100 
is communicating with an APL system. 
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Copy Display 



m 



To print the data displayed on the screen, press the copy display key. This key 
performs the same function in communications as it does in APL or BASIC 
language operations. During the copy display function, error codes are displayed 
on the left side of the status line. These codes are described in the 5100 APL 
Reference Manual and the 5100 BASIC Reference Manual. 



Tab 



D 



Pressing the tab key during transmit operations transmits a tab character and moves 
the cursor to the next tab position if the cursor is not beyond position 132. If 
there is no tab position to the right of the cursor, the cursor moves to position 132, 
which is always the last tab position. The tab character does not appear in the 
message on the display screen or in the extended display. Thus, if a message with 
tabs is edited and transmitted, blank characters are transmitted to make the message 
appear as if it contained the tabs. Pressing the tab key with the cursor beyond 
position 132 has the same effect as pressing the spacebar. 



Fast Left 



In a scroll operation, pressing the fast left key moves all lines on the display screen 
20 positions to the left if an arrow is displayed in position 64 on the status line. 



Fast Right 



E) 



In a scroll operation, pressing the fast right key moves all lines on the display screen 
20 positions to the right, but it will not move the data beyond position 1. 



Fast Up 



H 



In a scroll operation, pressing the fast up key moves all lines on the display screen 
up 14 lines. This key moves the data up if there is data to be moved to the screen. 



Fast Down 



Q 



In a scroll operation, pressing the fast down key moves all lines on the display 
screen down 14 lines. This key moves the data down if there is data to be moved 
to the input line. 
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Scroll Left 



Q 



In a scroll operation, pressing the scroll left key moves all lines on the display 
screen to the left if there is an arrow in position 64 of the status line. The lines 
continue to move to the left if this key is held down. 



Scroll Right 



In a scroll operation, pressing the scroll right key moves all lines on the display 
screen to the right if position 1 of the extended display is not in position 1 on the 
display screen. The lines continue to move to the right if this key is held down. 
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Communications Commands 



Communications commands modify the operations of the 5100. Enter the 
commands as follows: In the HOME state, enter the command character, &, 
by holding down the CMD key and pressing the alphameric 1 key, enter the 
command keyword and any parameters, and then press EXECUTE. Include a 
blank space between the keyword and each parameter entered. 

The syntax symbols used in the communications commands are: 

Symbol Meaning 

( \ Braces indicate that one of the required parameters must 

/ > be entered. 



data 



The data specified by the lowercase letters must be 
entered. 



Brackets indicate that one of the optional parameters can 
be entered. 



parameters The underscored parameter Is the default parameter if none 

is specified. 



&AUTO (OPTION T ONLY) 

The &AUTO command enables the 5100 to receive messages that are too large for 
the extended display. The syntax of the &AUTO command is: 

&AUTO 

Using the &AUTO command, transmission of a message occurs in the following 
manner: 

1. Start execution of a user-written program, located at the remote system. 

2. The remote system sends an auto response text as the last line of each 
section of the message. 
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After each section of the message is written and/or printed, the 5100 returns 
the auto response text as a complete line to the remote system to prompt 
transmission of the next section of the message. The auto response text is 
not printed or written on tape as part of the received message. 

Transmission ends when: 

a. The 5100 receives less than four lines. 

b. You hold down the shift key and press ATTN. 

c. A tape or printer error occurs. 

If less than four lines are received, the data Is not automatically written or 
printed so that error messages are not printed or written on tape. If you must 
save this data, start the edit operation and use the write or print key. 



&CLOSE (OPTION T ONLY) 

The &CLOSE command makes the tape on the specified tape unit unavailable for 
further data transfer and completes writing the data to an output file. You must 
use the &CLOSE command to close an output tape, or data may be lost from both 
the cartridge removed from the tape unit and the next cartridge inserted. The 
syntax of the &CLOSE command is: 



&CLOSE 



E80 
E40 



E80 specifies the built-in tape unit and E40 specifies the auxiliary tape unit. 



&OPEN (OPTION T ONLY) 

The &OPEN command makes the file on the specified tape unit available for data 
transfer. The syntax of the &OPEN command is: 



&OPEN 



<!oUT> { 

\ 1 V 



file number; 



E80 



E40 



(add) 

IN, OUT, or ADD specifies the type of tape file: 

• IN specifies that messages will be transmitted from the tape. 

• OUT specifies that messages will be written on tape, starting at the beginning of 
the file. The messages written on tape are determined by the &OUTSEL command. 
OUT destroys data previously written on the specified file even if no new data is 
written to the file. 

• ADD is the same as the OUT parameter except the messages are written 
following the last existing data on the file and always use at least 512 character 
positions. 

file number specifies the file number. 

E80 specifies the built-in tape unit and E40 specifies the auxiliary tape unit. 
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Note: If the &OPEN command is entered without parameters and any files are 
open, the tape unit address and the type of file open are displayed in this format: 

I; DDD O: DDD 

/ indicates input file, O indicates output file, and DDD indicates the tape unit 
address. 

For example: 

I: E80 0: 

indicates that an input file is open on the built-in tape unit. 



&OUTSEL 



The &OUTSEL command controls which lines are printed and/or written on tape. 
If the 81OUTSEL command is not entered, all data is printed and/or written. The 
syntax of the &OUTSEL command is: 

8.0UTSEL {^^5^} 

ALL specifies that all data transmitted and received is printed and/or written on 
tape. 

SYS specifies that only lines completed by the remote system are printed and/or 
written on tape. (A complete line is ended with a new-line character.) Lines 
transmitted from the 5100 and ended by pressing ATTN may also be printed 
and/or written (see A TTN Key). If you do not want the data printed, turn the 
printer off. 



81RATE (OPTION T ONLY) 

The &RATE command specifies the communication line rate of 134.5 or 300 bits 
per second (bps). If the &RATE command is not entered, the rate is 134.5. If you 
are using non-switched lines, the rate must be set when the characters in position 58 
and 60 of the status line indicate D t- Jf you are using switched lines, the rate must 
be set before the line connection is established. The syntax of the &RATE 
command is: 

^-- &} 

Notes: 

1 . The remote system must support the selected rate. 

2. Option P only supports 134.5 bps. 



16 



&SYSTEM 



The &SYSTEM command specifies the type of translation that is used for the EBCD 
notation and the error recovery procedure for errors that can occur at the remote 
system when the 5100 is transmitting. If the &SYSTEM command is not entered, 
the translation is OTHER. The syntax of the &SYSTEM command is: 



&SYSTEM 



APL 
APL.SV 
BASIC 
OTHER 



The parameter specifies the translation and error recovery: 

Error Recovery 



Parameter 


Translatioiv 


APL 


APL 


APL.SV 


APL 



Operator error recovery only. 

If the remote system receives an erroneous 
record from the 5100 and transmits 
RESEND, the 5100 resends the message. 
(The 5100 will not resend the message if 
an overflow is encountered.) This 
continues until the message is accepted by 
the remote system, or until the retry 
operations are interrupted when the ATTN 
key is pressed (see ATTN Key). The 5100 
keyboard then opens for input, and if 
transmitting from tape, the tape can be 
restarted with the &TAPEIN command. 

BASIC BASIC Operator error recovery only. 

OTHER BASIC Operator error recovery only. 

Note: In the BASIC translation, two characters cannot be combined to form a 
single character; the overstriking character replaces the existing character. The 
OTHER translation is the same as BASIC with one exception: When two 
characters are entered to form a single character, the combined character is 
replaced with an OUT (O backspace U backspace T) character. 



&TAPEIN (OPTION T ONLY) 

The &TAPEIN command specifies that the next message will be transmitted from the 
tape file (see Tape Input). The tape file must be opened and specified for input (IN). 
The tape is automatically closed when the last record is read from the file. The 
syntax of the &TAPEIN command is: 

&TAPEIN 
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Review of Commands and Special Function Keys 



COMMANDS 

Command Syntax 

&AUTO 



&CLOSE 



Fesq" 

Le40_ 



Function 

Allows the 5100 to receive messages 
that are too large for the extended 
display (option T only). 

Makes the tape unavailable for data 
transfer and connpletes writing the 
data to an output file (option T only). 



&OPEN 



OurUfne number} [!§] 



Opens the tape file for data transfer 
or lists the open files (option T only). 



^O^^S^"- {sYs} 



&RATE 



1134.5) 
1300 / 



&SYSTEM 



APL 
lAPLSV 
BASIC 
OTHER 



Specifies which messages will be 
printed and/or written on tape. ALL 
is assumed if no &OUTSEL command 
is entered. 

Specifies the bits per second (bps) 
rate. 134.5 is assumed if no &RATE 
command is entered (option T only). 

Specifies the EBCD translation and 
error recovery options. OTHER is 
assumed if no &SYSTEM command 
is entered. 



&TAPEIN 



Specifies that the input will be from 
the tape unit instead of the keyboard 
(option T only). 
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SPECIAL FUNCTION KEYS 



Note: Hold the CMD key down, 
special function. 

Key 







CD 



Command character 



Edit 



then press the specified key to activate the 



Function 



Displayed as &, and is the first character 
for commands. 



Line delete 



m 

CD 

6 I Tab reset 

CD 



Shift lock 



Tab set 



Print 



Home 



Write (option T only) 



OUT character 



Starts the edit operation. 



Deletes all characters on the input line to the 
right of and at the cursor position. 

Changes the 5100 shift status, and transmits 
the appropriate shift character if required. 

Sets a tab at the cursor position. 



Clears the tab, if any, at the cursor position. 



Prints the data stored in the extended display 
from the irtput line to the end of the 
extended display. 

Restores the displayed data to its home 
position. 

Writes the data stored in the extended display 
on tape from the input line to the end of the 
extended display. 

Displays the OUT character on the input 
line, and also transmits it if the 5100 is 
transmitting (APL and APL.SV only). 
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Key 



Function 






— — — > 

Tab 


2 


Fast left scroll 


3 


Fast right scroll 


5 


Fast up 


6 


Fast down 


8 


Scroll left 


M 


Scroll right 


n 


Scroll up 


o 


Scroll down 


hi 


Copy Display 



Transnnits the tab character and moves the 
cursor. 

Moves the data on the display screen 20 
positions to the left. 

Moves the data on the display screen 20 
positions to the right. 

Moves the data on the display screen up 14 
lines. 

Moves the data on the display screen down 
14 lines. 

Moves the data on the display screen one 
position to the left. 

Moves the data on the display screen one 
position to the right. 

Moves the data on the display screen up one 
line. 

Moves the data on the display screen down 
one line. 

Prints the data displayed on the screen. 
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Message Input and Output Devices 



You can use the keyboard and tape units to transmit data and the printer and/or 
tape unit to record received data. All data transmitted and received is displayed on 
the input line of the display screen. Commands and incomplete lines of data 
displayed on the input line are not printed or written on tape. (An incomplete line 
is a line not ended with a new-line character.) 



TAPE (OPTION T ONLY) 

You can use the tape unit for input or output if option T is selected. If the 
auxiliary tape unit is installed on your 5100, you can use either tape unit for input 
or output; however, you cannot use them simultaneously. 

Tape cartridges used in communications are unlabeled (there is no automatic tape 
labeling or checking) so you must use care to protect your existing tape files. The 
SAFE feature on the tape cartridge prevents writing to an input file. Do not remove 
an output tape from the tape unit before closing it with the &CLOSE command, or 
data may be lost both on the cartridge removed and the next cartridge inserted. 



Tape Input 

When the tape is used for input, the tape supplies the messages to be transmitted. 
The specified tape file must contain only character data records (file type 1, 2, or 
3). For a description of these file types, see the 5100 APL Reference Manual or the 
5100 BASIC Reference Manual. Use the &OPEN command to open the file and 
define it as an input file. Then enter the &TAPEIN command to specify that the 
input will be supplied from the tape. If a tape, printer, or received error (code 091) 
occurs, the tape input operation is terminated and can be started by reentering the 
&TAPEIN command. 

When the last record is read from the file, the tape is automatically closed and DONE 
is displayed on the status line. To stop transmitting from the tape, hold down the 
shift key and press the ATTN key. No data is lost and you can resume transmitting 
by reentering the &TAPEIN command. 
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Tape Output 



When the tape is used for output, messages transmitted and received are written 
on tape, provided the tape was previously marked. The &OUTSEL command 
specifies the lines to be written on tape, and the &OPEN command opens the file 
and defines it as an output (OUT or ADD) file. For an OUT file, data is written 
starting at the beginning of the file. For an ADD file, the data is written following 
the last existing data on the file and always uses at least 512 character positions. 
The output file created is a type 2 file if the file is an OUT file and remains as is if 
the file is an ADD file. 

Note: No checking is done on OUT files, and any file can be overwritten. 

Tab, line feed, and backspace function characters are not written on tape. Tabs 
are simulated by inserting the correct number of blanks in the data, and line feed 
characters are simulated by writing a new-line character and the correct number of 
blanks to indicate the start of the next line. Valid overstrike characters are written 
as one character. 



PRINTER 



The &OUTSEL command controls which lines will be printed if the printer is on 
during communications. When using option T, the lines are printed after the 
complete message is received or transmitted. When using option P, the lines are 
printed as each line is received. If you are using preprinted forms, the character 
spacing on the printer is 10 characters per inch and the line spacing is six lines per 
inch. 

With option T, the message size is restricted by the size of the extended display. 
The maximum message size is at least: 

5100 Model Size 

A1, B1, CI IK (K=1024 characters) 

A2, B2, C2 17K 

A3, B3, C3 33K 

A4, 84, C4 49K 

The maximum printer width is 132 characters. If the lines are longer than 132 
characters, an OUT (0 backspace U backspace T) character is printed in position 
132 and any characters beyond position 131 of the line are not printed. 



BYPASS FUNCTION (PRINT INHIBIT) 

The bypass function is activated by the remote system to inhibit output from the 
5100 for security purposes. To ensure data security, you should not use the edit 
operation or the &TAPEIN command when the bypass function is active. Use the 
home key to reset the bypass function to normal. When bypass is active, characters 
typed on the keyboard will be sent (the cursor advances with each keystroke), but 
not printed or written to output devices. 
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COMPOSING MESSAGES OFFLINE 

When the 5100 is offline, you can compose messages, write them on tape for later 
transmission, or print them. Writing and printing start with the data moved to the 
input line and continue to the end of the extended display. 

To compose a message in the extended display with the 5100 offline, follow these 
steps: 

1. Press the edit key (CMD and alphameric 2) to start the edit operation. 

2. Enter a line from the keyboard. 

3. Press the home key (CMD and alphameric 8). This enters the line in the 
extended display and moves the data on the display screen up one line. 

Repeat steps 1, 2, and 3 until the message is complete. The data in the extended 
display can now be written on tape or printed. 

To write the data on tape, use the following procedure: 

1. Insert the tape cartridge in the tape unit and open the file for output with 
the &OPEN command. 

2. Move the line with the &OPEN command back to the input line, then press 
the edit key. 

3. Press the line delete key (CMD and alphameric 3). This deletes the &OPEN 
command from the extended display so it will not be written on tape. 

4. Press the home key and move the first line of the message you want to 
write on tape to the input line. 

5. Press the edit key (CMD and alphameric 2) and then press the write key 
(CMD and alphameric 9) to write the data on tape. 

6. Enter the &CLOSE command before removing the cartridge to ensure that 
the data is stored. 

To print the data in the extended display, move the first line of the message to be 
printed to the input line, start the edit operation by pressing the edit key, and press 
the print key (CMD and alphameric 7). This procedure can be repeated to obtain 
multiple copies. 

TRANSMIT INTERRUPT 

When the 5100 is transmitting, the remote system can interrupt the transmission, 
cause the 5100 to go to receive status, and transmit a message. During option P, 
this interrupt is honored and the message is accepted. During option T, the 
interrupt is honored only during sign-on or if no tape or printer operation is in 
progress. 
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State Indicators 



You can use the state indicator (positions 53-56 of the status line) to determine 
what the communications prograrp expects for input and what action it tal<es. The 
states are HOME, EDIT, SCRL (scroll), XMIT (transmit), and PROC (process). The 
states, the keys you can press, the results, and the next state the communications 
program enters are as follows: 

Note: The special functions are activated by holding down the CMD key and then 
pressing the appropriate key. 



HOME 




Keys 




M 


Command 


2 


Edit 


< 

4 


Shift lock 


5 


Tab set 


> 

6 


Tab reset 


8 


Home 


+ 


OUT 


B 


Backspace 




Forward space 



Results Next State 



Enters the command character. EDIT 



Starts the edit operation. EDIT 



Changes the 5100 shift status, HOME 

and transmits the appropriate 
shift character if required. 

Sets a tab at the cursor position. HOME 



Clears the tab, if any, at the HOME 

cursor position. 

Resets the bypass function. HOME 



Transmits an OUT character XMIT 

(APL and APL.SV only). 

Transmits a backspace function XMIT 

character (CMD key not required). 

Same as space bar (CMD key not XMIT 

required). 
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Keys 



Results 



Next State 



Tab 



Transmits a tab character and 
moves the cursor. 



XMIT 



EXECUTE 



Transmits a new-line and an end 
of transmission character. 



PROC/HOME 



ATTN 



Transmits an end of 
transmission character. 



PROC/HOIVIE 



Any scroll key 



Moves the data on the display 
screen. 



SCRL 



Any data key 



Transmits the data character. 



XMIT 



EDIT 



Keys 



Results 



Next State 







Line delete 



Shift lock 



Tab set 



Tab reset 



[ > 1 Print 



Deletes all characters to the EDIT 

right of and at the cursor 

position. 

Changes the 5100 shift status, EDIT 

and transmits the appropriate 
shift character if required. 

Sets a tab at the cursor position. EDIT 



Clears the tab, if any, at the EDIT 

cursor position. 

Prints the contents of the EDIT 

extended display from the 
input line to the end of the 
extended display. 
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Keys 



Results 



Next State 



m 



Home 



Write 

(option T only) 



OUT 

Backspace 
Forward space 
Delete 
Insert 



EXECUTE 



ATTN 



Any data key 



Terminates the edit operation HOME 

and moves the displayed data 
up one line. 

Writes the contents of the extended EDIT 
display on tape from the input line 
to the end of the extended display. 

Displays the OUT character at the EDIT 
cursor position (APL and APL.SV 
only). 

Moves the cursor to the left (CMD EDIT 
key not required). 

Moves the cursor to the right (CMD EDIT 
key not required). 

Deletes the character at the EDIT 

cursor position. 

Inserts a blank at the cursor EDIT 

position. 

Transmits a message and the new- PROC/HOME 

line and end of transmission char- 
acters, or processes the command. 

Transmits a message and an end of PROC/HOME 
transmission character, or processes 
the command. 

Displays the character at the cursor EDIT 
position. 



SCRL 



Keys 



Edit 



Home 



Any scroll key 



Results Next State 

Starts the edit operation. EDIT 

Terminates the scroll operation, HOME 

resets the bypass condition, and 
restores the displayed data to its 
home position. 

Moves the data on the display SCR L 

screen. 
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XMIT 

Keys 



Results 



Next State 



CD 



m 



Shift lock 



Tab set 



Tab reset 



OUT 



Backspace 



Forward space 



Changes the 5100 shift status, XMIT 

and transmits the appropriate 
shift character if required. 

Sets a tab at the cursor position. XMIT 



Clears the tab, if any, at the XMIT 

cursor position. 

Transmits the OUT character XMIT 

(APL and APL.SV only). 

Transmits a backspace function XMIT 

character and moves the cursor 
to the left. 

Same as space bar. XMIT 



Tab 



EXECUTE 



ATTN 



Any data key 



Transmits the tab character and XMIT 

moves the cursor. 

Transmits a new-line and an end PROC/HOME 

of transmission character, and 
does I/O processing. 

Transmits an end of transmission PROC/HOME 

character, and does I/O 

processing. 

Transmits the data character. XMIT 
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PROC 



The PROC state indicates that the 5100 is doing internal processing. The 5100 
goes to the home state when processing is complete. 



Keys 

ATTN 



Results 



Home State 



Transmits a long space if the 5100 HOME 

is receiving. 



Shift and ATTN 



Stops the current operation as soon HOME 

as possible. 



CMD and ATTN 



Returns the 5100 to the home state. 
(This key is only to be used if the 
5100 cannot be returned to the home 
state from the process state by pressing 
only the ATTN key.) 



HOME 
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Error Codes 



Error codes are displayed on the status line in positions 17 to 27 (general status 
area), 28 to 40 (tape status area), and 41 to 51 (printer status area). 

The following list provides a brief description of the error codes that are common 
to communications and APL or BASIC language operations. For a complete 
description of these error codes and the recovery procedure, see the 5100 APL 
Reference Manual or the 5100 BASIC Reference Manual. 

Code 

002 Command error 

003 Status error 

004 Time-out 

005 Tape not inserted 

006 File protect 

007 CRC error 

008 Position error 

009 End of data— may also indicate a normal condition 

010 End of file 
Oil End of marked file 

012 Physical end of tape 

013 Device not attached 

014 Device not selected 

050 End of forms 

051 to 059 Printer errors 

The preceding error codes are displayed in this format: 

SSS: DDD 

SSS is the error code and DDD is the device address: 

E80 = Built-in tape unit 
E40 = Auxiliary tape unit 
500 = Printer 
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The following error codes and messages apply only to the communications program: 
Code Message 

081 The command entered is invalid. 

084 The specified file is not available. 

085 The file type is incorrect. (The file type is also 

displayed.) 

086 See Invalid Tape Data. 

087 The file is not open. 

088 The file is already open. 

089 The rate is already set. 

090 (option T only) Overflow— The extended display is full (see Overflow). 

091 The message just received contains invalid 

characters. (The message is not printed or written 
on tape.) 

092 (option P only) The 5100 is receiving data too fast for the printer, 

and the remainder of the message has been lost. Some 
printing may occur after this code is displayed. 

099 The communications program has detected an 

internal error. Restart the 5100, and retry the 
operation. If the error continues to occur, call for 
service. 

DONE The command has been successfully processed. 

The preceding error codes are displayed as shown under Code. 
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INVALID TAPE DATA 

When invalid data (nontranslatable codes, OUT characters, and nongraphics) is read 
from tape, the error code 086 is displayed on the status line. The 5100 goes to the 
home state, and the line containing invalid tape data is moved up one line. At this 
time you can: 

• Enter the &TAPEIN command to bypass the line with invalid data and continue 
transmitting. 

• Enter new data from the keyboard, and press EXECUTE to transmit it in place 
of the line with invalid data. Enter the &TAPEIN command to continue 
transmitting from tape. 

• Move the data to the input line, start the edit operation, correct the data if 
desired, and press EXECUTE to transmit it. Enter the &TAPEIN command to 
continue transmitting from tape. 



OVERFLOW (OPTION T ONLY) 

If a message larger than the extended display is received by the 5100, the error code 
090 is displayed on the status line and the data is not printed or written on tape. The 
last portion of the message is stored in the extended display and the first portion is 
lost. If the overflow data included tab or line feed characters, some characters 
in the extended display may not be valid. 



PRINTER ERROR RECOVERY 

If option T is specified and a printer error occurs during receive operations, the 
printer stops and the 5100 goes to the home state. You can continue the receive 
operation or retry the print operation with the following procedure: 

1. Move the paper to a new line or page. 

2. Move the first line to be printed to the input line on the display screen. 

3. Press the edit key (CMD and alphameric 2), and then press the print key 
(CMD and alphameric 7) to retry the print operation. 

4. Press the home key (CMD and alphameric 8) and continue the receive 
operation. 

If option P is specified and a printer error occurs during receive operations, the 
printer stops, the rest of the message is placed in the extended display, and the 
5100 goes to the home state. To continue, use the procedure described for 
option T. 
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Appendix A. Installation Instructions 



To prepare the 5100 Communications Adapter feature, connect the RS-232-C cable 
(P/N 1608553) between the data set or modem and the 5100 communications 
connector as shown: 



Communications 
Connector 




.^ 
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After connecting the cable, use the following procedure to verify the operation of 
the communications feature: 

1. Insert the tape cartridge containing the communications program in the 5100 
built-in tape unit. 

2. Enter the command )MODE COM if you are using APL or UTI L MODE COM 
if you are using BASIC, and press EXECUTE. If the program displays the 
options T or P, enter a T. (If the printer is not attached, the options will not 
be displayed.) The program should load and display HOME on the bottom 
line of the display screen. 

3. Enter the commands to initialize the communications program: 

a. Hold down the CMD key and then press the alphameric 1 key. The 
character & should be displayed. Enter the command SYSTEM and the 
parameter APL, APL.SV, BASIC, or OTHER depending on the remote 
system you will be communicating with. For example, if you will be 
communicating with an APL.SV system, the command you enter is 
&SYSTEM APL.SV. Press EXECUTE to process the command. 

b. Enter the &RATE command in the same manner. The parameters for the 
&RATE command are 134.5 and 300, which are the bits per second (bps) 
rate of the communication line. If your system uses 300 bps, enter &RATE 
300 and press EXECUTE to process the command. 

4. Establish the line connection by dialing the remote system if you are using 
switched lines. If you are using non-switched lines, the connection should now 
be complete. 

5. Enter the sign-on code for the remote system and press EXECUTE, The 
remote system should acknowledge the sign-on to indicate that the 5100 is 
online. 

6. Sign off. This completes the installation and checkout of the Communications 
Adapter feature. If you have any difficulty in checking out the feature, call 
your IBM marketing representative for assistance. 
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Appendix B. Sample Tape Communications and Programs 



WRITING BASIC PROGRAMS ON TAPE 

A BASIC program can be written on tape with the BASIC corhmand: 

SAVE file number SOURCE 

The program is written on tape in character record format and can then be 
transmitted to the remote system during communications by using the &OPEN and 
&TAPEIN commands. 

During communications, BASIC programs residing at the remote system can be 
written on tape by using the LIST command. The size of the program is limited 
by the size of the extended display, and a program larger than the extended display 
cannot be listed in its entirety. 

Data transmitted from a remote system to tape for later processing during BASIC 
language operations must conform to a specific format: 

1. Character data must be enclosed in single quotation marks and blocked 
together in segments that contain a maximum of 1 8 characters, for example: 

'THE SQUARE OF X IS', 'GREATER THAN Y' 

An apostrophe must be indicated by two single quotation marks, for example: 

'DON'T 

2. Numeric data must also be formatted in strings of less than 19 characters; 
however, no quotation marks are used. For example: 

11,12,13,14,15 

WRITING OTHER LANGUAGE PROGRAMS ON TAPE 

Other language programs such as FORTRAN or PL/1 can be entered from the 
5100 keyboard in the extended display and then written on tape and transmitted 
(see Composing Messages Offline). 
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WRITING APL FUNCTIONS ON TAPE (APL.SV) 

APL functions cannot be transmitted directly in executable form. Convert the 
functions to variables using D CR. The functions can then be transmitted as 
character strings, which can later be converted with Q FX and stored In the 5100 
APL workspace. Arrays and matrices must be transmitted as vectors. 

To receive a function from one remote system, write it on the 5100 tape, and 
transmit it to another remote system, use the following procedure: 

1 . Put the 51 00 online with the first system. 

2. To receive the function, enter: 

&OUTSELSYS 

&OPEN OUT file number |^ 



Vf unction name [Q] V 
&CLOSE 



[eso] 

Le40J 



3. Put the 5100 online with the second system. 

4. To transmit the function, enter: 



&OPEN IN file number 
&TAPEIN 



[esoI 

LE4oJ 
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Sample Functions 

The following routines are an example of how you can transmit variables from a 
remote APL.SV system to the 5100 tape. The AAATTR and AASEND routines 
should be keyed into a workspace on the remote system, and the AARECEIVE 
routine should be keyed into the 5100 workspace. The functions to be 
transmitted must be converted to variables using D CR. 

Follow this procedure: 

1. Using the )LOAD command, load the remote system with the sending routine 
and the variables to be sent. 

2. Insert the tape cartridge in the 5100 tape unit. 

3. Enter the following: 

&OUTSELSYS 



&OPEN OUT file number 

AASEND 'variable name' (for each function to be sent) 

&CLOSE 



4. Return the 5100 to normal APL operation. 

5. Using the )LOAD command, load the 5100 workspace with the AARECEIVE 
function. 

6. Execute the function AARECEIVE. 
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The following are samples of the AAATTR, AASEND, and A A RECEIVE 
functions: 



V AASEND AANAMEjAADATA; 0:1:0 ;nPW 
tt AANAME :i:S A CHARACTER VECTOR 
OF THE OBJECT NAME 



31 
ii:.l 
51 
61 

7::i 
B::i 
9::i 
:i. {) ::i 



[ 

i:j.2::i 

i::i.3::i 

[::i.ii:i 

i:::i5::i 

i:::i.6:3 

i:::L7::i 

i:::i.8:3 

i:::i.9::i 

i:2o::i 



th:i:b routj:ne bend*" 
(functions must be 
from a remote apl 



;:> A VAR;r.ABL 
DCR'ED) 



BV SYSTEM TO THE 510 



when aasend :i:s executed 
to put the output on tap 
res:i:de on the 



THE 



A A ATT R.f AANAME 



ft AND AAATTR 
nPW<-390 
UUHl 

'mm' , AANAME. ' ' 
AADATA<"f , A AANAME 

A AD AT A i:: ( AADATA====OAVi:: 1571 ) / \ paadata:m 

AALOOP : ■■> ( 0=^^:pAADATA ) /AAEND 
' oswoj * , ( 1251.. r:>AADATA ) t AADATA 
AADATA<"(125LpAADATA)4AADATA 
■•* AALOOP 

AAEND : ' (,)(.)(.) ■ V 



510 SHOULD BE 
. THIS ROUTINE 
REMOTE SYSTEM . 



SET 



VZ<- AAATTR X 
ItZ IS S 
ItllZ IS 



R 

OR A 
C OR 



i.. .1. J rt 

i:2::i i\ 

i::3;:i n 2*z 

i:"i::i r<-ppX 

i:5:;i n-i (R:=::0), (r>0))/ 

i:.6::i z<"Z, < (o^itopX) , < 

i::7::i ••»(R:==o)/o 

i:.b:i z^z. fpx v 



FOR SCALAR OR ARRAY 
N FOR CHARACTER OR NUMERIC 
IS THE SHAPE OF X (CHARACTER) 



SA' 
•====ltOpX) )/ 



NC 
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V AARECE :i:VE AANAME ; AADATA ; AALINE ; &AHEAD ; AAXN ; AAI ; OID ; OPW 

i::2::i uuu-i 

\:31 tt TO RECEIVE VARIABLES ON THE 5:1.0 0. 

:m-::i o 

151 ft this routine reads the tape created by the ' aasend ' 

i::6::i « routine on the remote system. 

:7::i r 

i::e::i -k';*;^! osvo 'aain' )/o 

i: 9 ::i ■ s pec i e y de v i vce/f i le numbe r ' 

:l.o::i AAIN^-'IN ' ,\!\ 

:l.i:*J ••KOiP<i-*/AAIN)/0 

:i.2::i aafind : ■•> < o==:=paahead<"Aain ) /aaeof 

131 -K^a/ ' mm ' ====3tAAHEAD)/AAFIND 

LV\1 AAI<"(AAHEAD<"3iAAHEAD) V ' ' 

i:: :i.5::i ■* ( o=^=paaname > /aaconto 

i:: 161 ■■> ( a/aaname:=== < pAaname ) t aai t aahead > /aafnd 

nil AANEXT : -K a/ ' otojtx ' =:=:3t AALINE<-AAIN )/AANEXT 

i:::i.b::i -^aafind 

!:::i.9::i aafnd:Aaname<s-' ■ 

i::2o::i aaconto : aadata<- ■ • 

r-2i:i AALOOP : •■>( A/ • www ' ::<:UAALINE<"AAIN>/AAF0RMIT 

i::22::i ■■> ( '^a/ • mm ' -=3 tA aline > /aaloop 

i: 23 :i ••><(( X 25 1 3 * AAL I NE ) x IIIA V f! 1 7 ::i ) > 1 25 ) / A ACONT 

t::2ii:i o^-aaline 

C25:J AALINE<-iri 

\:.261 AACONT : AADATA^-AADATA , :l.25t3^AALINE 

i::27:3 ••> aaloop 

i::2s:i aaformit : aadatai: < aadata==== "■ ' ) / \ pAADATa:i<-oavi:: :i.57::i 

i: 29 :3 "K * A ■ :== :i. t A A 1 4- AAHEAD ) / A A A R RAY 
i:30::i -U. • C • ====:!. t ( aai M > 4.AAHEAD)/AASCHAR 

i::3i::i o numeric scalar 

i::32::i .*. ( aai t aahead )>•<■■', a ad at a 

i::33:i -^aadone 

i::3i+::i nCHARACTER SCALAR 

i::35:i aaschar : .♦.( aai t aahead ) > ' ^-aadata ' 

C36::i -^AADONE 

r.37J ft ARRAYS 

i::3b::i aaarray ■■■h'c ==:=:i. t < aaim > i aahead > /aaachar 

f::39:] ^numeric array 

i::mo ::i ••> < 0:=^pAAData ) /aannull 

i: li :l. 1 A ( AAI t AAHEAD );■<••',(( A A I f 2 ) i AAHEAD ) , ' p' , A AD AT A 

i:;'.i-2:i -^aadone 

i: M-3 ::i aannull : a ( a a i t aahead ) , ' <•• \ o ' 

i::mii-:i -^aadone 

I:M-5:3 h CHARACTER ARRAY 

i:.ti6::i aaachar : •■> < o=::=paadata ) /aacnull 

i:.M-7:i i. ( AAI t AAHEAD ) r ^- ' > (. < AAIt-2 ) i AAHEAD ) , ' pAADATA ' 

i::m-8:3 -k ' a ' i^i t aahead > /aadone 

i:«-i-9::i ' function • , ( i::ifx a aai t aahead ) , • created ■ 

i:5o::i aak-gex aai t aahead 

i:5i::i ••>aafind 

i:52::i aacnull : .+.( aai t aahead ) , •<•• 

1:53:1 AADONE : ■ VARIABLE ' , ( AAI t AAHEAD ) , ' CREATED ' 

i:5ii;:i -^aafind 

i::55::i aaeof : ■■> < 9====+/aain ) /aafind 

i::56J ' <::<:: c: END OF FILE ->::)::)' V 
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SAMPLE PROGRAMS USING THE giAUTO COMMAND 
Sample BASIC Program 

DOOIO REM THIS PROGRAM IS AN EXAMPLE 

020 REM OF USING THE AUTG COMMAND. 

030 REM 

OOOMO FOR N ====:!. TO 16 

015 PRINT N 

060 PRINT NM 

070 PRINT N^2 

080 PRINT N-4-3 

090 REM THIS LAST NUMBER IS THE 

:i. R i:;: m a u j o r i:;: s p g n s p; j e. x t . 

OOIIO INPUT I 

0120 IF 1-^^H-i'Z GOTO 150 

0130 PRINT "ERROR' 

OOlM-0 GOTO 180 

01150 N""Ni-2 

0160 NEXT N 

017 REM ALL IS OK . 

0180 STOP 

019 END 

The extended display The extended display 

The printed output is: using &AUTO contains: without &AUTO contains: 

•| &AUTO 1 

2 RUN 2 

3 1 3 
'•I- 2 '•!• 

5 3 V !.i. 

6 M- i-i- 



it- 



-.J 



I'-i- 10 10 

1 :^=i 1 ? 



1 ;i. 
12 

'i A 



1 i| 

15 
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Sample APL Program 



i::3::i 
i::m::i 
i::5::i 

161 

i::7::i 
i::8::i 
i::9::i 
i:: :i. 



V AASENDAALL ;I 

ftTHXB RGUT:i:Ni!;: w:i:ll send the large character 

nARRAY CHAR TO THE 5:1.00 I.N 10 ROW SECTIONS 
ftFOR PRINTING AND TAPE USING THE AUTO COMMAND 

S:CHARi::i*\:i.O; ::i 

••K30====I<-I-*:l.0)/E 
■CONTINUE" 

■•Ka/'CONTINUE'====W)/S 
•M) 
E: 'STOP' 

4(A/'STOP'====e:i)/o 

'ERROR' V 



The character array 
'char' is: 

ABCDEFGHIJ 
KLMNOPQRST 
UVWXYZABCD 
EFGHIJKLMN 
OPQRSTUVWX 
YZABCDEFGH 
IJKLMNOPQR 
STUVWXYZAB 
CDEFGHIJKL 
MNOPQRSTUV 
WXYZABCDEF 
GHIJKLMNOP 
(SRSTUVWXYZ 
ABCDEFGHIJ 
KLMNOPQRST 
U'\/WXYZABCD 
EFGHIJKLMN 
OPQRSTUVWX 
YZABCDEFGH 
IJKLMNOPQR 
STUVWXYZAB 
CDEFGHIJKL 
MNOPQRSTUV 
WXYZABCDEF 
GHIJKLMNOP 
QRSTUVWXYZ 
ABCDEFGHIJ 
KLMNOPQRST 
UVWXYZABCD 
EFGHIJKLMN 



The extended display 
with &AUTO contains: 

^OUTSEL SYS 

aAUTO 

AUTOSEND 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 

OPQRSTUVWX 

YZABCDEFGH 

IJKLMNOPQR 

STUVWXYZAB 

CDEFGHIJKL 

MNOPQRSTUV 

CONTINUE 

WXYZABCDEF 

GHIJKLMNOP 

QRSTUVWXYZ 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 

OPQRSTUVWX 

YZABCDEFGH 

IJKLMrsR:)PQR 

CONTINUE 

STUVWXYZAB 

CDEFGHIJKL 

MNOPQRSTUV 

WXYZABCDEF 

GHIJKLMNOP 

QRSTUVWXYZ 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 

STOP 



The printed output is: 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 

OPQRSTUVWX 

YZABCDEFGH 

IJKLMNOPQR 

STUVWXYZAB 

CDEFGHIJKL 

MNOPQRSTUV 

WXYZABCDEF 

GHIJKLMNOP 

QRSTUVWXYZ 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 

OPQRSTUVWX 

YZABCDEFGH 

IJKLMNOPQR 

STUVWXYZAB 

CDEFGHIJKL 

MNOPQRSTUV 

WXYZABCDEF 

GHIJKLMNOP 

QRSTUVWXYZ 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABCD 

EFGHIJKLMN 
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Appendix C. Translation Codes 



The &SYSTEM command allows for a different translation to the EBCD notation. 
Both the 5100 and the remote system must use the same translation. 

When the APL or APL.SV translation is used, valid APL overstrike characters are 
allowed. Invalid overstrike characters are replaced by the OUT (O backspace 
U backspace T) character on the display screen, but are transmitted as they are 
entered from the keyboard. When invalid codes are read from tape, they are 
converted to OUT characters and the error code 086 is displayed on the status 
line. 

In the BASIC translation, two characters cannot be combined to form a single 
character; the overstriking character replaces the existing character. 

The OTHER translation is the same as BASIC except that combined characters are 
replaced by OUT characters. 



CHARACTER CODE CHART 

The character code chart shows the bit value of the EBCD characters that are 
transmitted and received by the 5100. 

All lower shift BASIC alphabetic characters are displayed as uppercase characters, 
but are transmitted as lowercase characters. Alphabetic characters received are 
displayed as uppercase whether they are uppercase or lowercase. For example, 
if the A key is pressed, an uppercase A is displayed on the screen, but a lowercase 
a is transmitted. Other BASIC characters are displayed and transmitted as shown 
on the chart. 

All APL characters are displayed and transmitted as shown on the following chart: 
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APL Characters 


BASIC Characters 


6 BCD Characters 


Bit Value 


Lower 
Shift 


Upper 
Shift 


Lower 
Shift 


Upper 
Shift 


Lower 
Shift 


Upper 
Shift 


B A 8 4 2 1 C 


A 
B 
C 
D 
E 


a 
1 
n 
L 
e 


A 
B 
C 
D 
E 




a 
b 
c 
d 
e 


A 
B 
C 
D 
E 


B A 1 

B A 2 

B A 2 1 C 

B A 4 

B A 4 1 C 


F 
G 
H 
I 
J 


V 
A 
\ 




F 

G 

H 

1 

J 




f 

g 

h 
i 
J 


F 
G 
H 

1 
J 


B A 4 2 C 
B A 4 2 1 
B A 8 

BAB 1 C 
B 1 C 


K 
L 
M 
N 



t 

D 
1 

T 
O 


K 
L 
M 
N 





k 

1 

m 

n 




K 

L 
M 
N 



B 2 
B 2 1 
B 4 C 
B 4 1 
B 4 2 


P 
Q 
R 
S 
T 


9 

P 

r 


P 
Q 
R 
S 
T 




P 

q 

r 
s 
t 


P 
Q 
R 
S 

T 


B 4 2 1 C 
B 8 C 
B 8 1 

A 2 C 
A 2 1 


U 
V 
W 
X 
Y 


u 

f 


U 
V 
W 
X 
Y 




u 

V 

w 

X 

y 


U 
V 

w 

X 
Y 


A 4 C 
A 4 1 
A 4 2 
A 4 2 1 C 
A 8 C 


Z 

i 

• 
] 


c 

( 

> 

) 


Z 
$ 

# 


! 
1 

n 


z 

$ 

# 


z 

! 

1 
It 


A 8 1 
BAB 21 
B 8 2 10 

A 8 2 10 
8 2 1 


X 

+ 

/ 

1 


\ 


@ 
& 

/ 
1 


+ 
7 


@ 
& 

/ 
1 


+ 


A 
B A 
B 

A 1 


2 
3 

5 
6 


< 
< 

> 


2 
3 
4 
5 
6 


< 
% 


2 
3 
4 
5 
6 


< 

% 


2 

2 1 
4 

4 1 
4 2 


7 
8 

9 



> 

V 
A 


7 
8 
9 



> 

( 
) 


7 
8 
9 



> 

( 
) 


4 2 1 
8 

8 1 
8 2 
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Note: For OTHER and BASIC translations, the following characters are entered 
when the CMD key is held down and the indicated key is pressed: 



Key 


Character Entered 


1 
@ 


t 


(: 


II 


\ 
/ 


% 


& 


! 



FUNCTION CHARACTER CODE CHART 

The function character code chart shows the bit configuration of the function 
characters and whether they are received or transmitted. 



Function 




Bit Value 




Character 


B 


A 8 4 2 1 C 




Tab 


B 


A 8 4 1 


Received and transmitted 


Upper Shift 




8 4 2 


Received and transmitted 


Lower Shift 


B 


A 8 4 2 


Received and transmitted 


Backspace 


B 


8 4 2 C 


Received and transmitted 


Space 




C 


Received and transmitted 


New-line 


B 


8 4 1 C 


Received and transmitted 


Start of 








transmission 




8 2 1 


Received and transmitted 


End of 








transmission 




8 4 2 1 C 


Received and transmitted 


Bypass 




A 8 4 


Received only 


Restore 


B 


8 4 


Received only 


Line feed 




A 8 4 1 C 


Received only 
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Index 



ATTN key 8 



installation 33 
invalid tape data 



32 



bypass 23 



CMD key 9, 20 
command cha/'acter key 9 
communication commands 14 

&AUTO 14 

&CLOSE 15 

&OPEN 15 

&OUTSEL 16 

&RATE 16 

&SYSTEM 17 

&TAPEIN 17 
communications status line 5 
copy display key 12 



display screen 3 



keys 8 
ATTN 8 
CMD 9, 20 
command character 
copy display 1 2 
edit 1 
EXECUTE 9 
fast down 1 2 
fast left 12 
fast right 12 
fast up 1 2 
HOLD 9 
Home 1 1 

line delete 10 
OUT character 1 1 
print 1 1 
scroll left 13 
scroll right 13 
shift lock 10 
tab 12 
tab reset 10 
tab set 10 
write 1 1 



edit key 10 
edit operation 7 
EDIT state indicator 
error codes 30 
EXECUTE key 9 
extended display 3 



26 



line 4 

line delete key 



10 



HOLD key 9 
home key 1 1 
HOME state indicator 



25 



message 4 



fast down key 1 2 
fast left key 1 2 
fast right key 12 
fast up key 1 2 



option P 1 
option T 1 
OUT character key 
overflow 32 



11 
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print inhibit 23 tab Icey 12 

print key 11 tab reset Icey 10 

printer output 23 tab set Itey 10 

PROC state indicator 29 tape input 22 

tape output 23 
translation codes 42 
transmit interrupt 24 



SCRL state indicator 27 

scroll left key 13 

scroll operation 5 

scroll right key 13 write key 11 

shift lock key 10 

state indicator 25 

EDIT 26 

HOME 25 

PROC 29 

SCRL 27 XMIT state indicator 28 

XMIT 28 
status line 5 
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READER'S COMMENT FORM 



IBM 5100 SA21-9215-0 

Communications 

Reference Manual 

YOUR COMMENTS, PLEASE ... 

Your comments assist us in improving the usefulness of our publications; they are an important 
part of the input used in preparing updates to the publications. All comnrwnts and suggestions 
become the property of IBM. 

Please do not use this form for technical questions about the system or for requests for additional 
publications; this only delays the response. Instead, direct your inquiries or requests to your IBM 
representative or to the IBM branch office serving your locality. 

Corrections or clarifications needed: 

Page Comment 



Due to the current paper shortage, we will not send a reply to your comments unless you 
check the box below. 



I would like a reply. I I 



Name _ 
Address 



* Thank you for your cooF>eration. No postage necessary if mailed in the U.S.A. 



SA21-9215-0 



Fold 



Fold 
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Publications, Dept. 245 
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CD 



o 
o 

o 
o 

3 

3 

c 

3 



3D 



CD 
3 
O 
(D 

a> 

3 
C 
&> 



Fold 



Fold 



3 

c 
> 
> 

(b 
ro 

cn 
o 
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o 
o 

o 

o 
3 

3 
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c 

> 
> 

N) 
CO 

? 

O 
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